SmartAgent Version 10.1.3
发布日期：2026 年 7 月 8 日
版本概述
SmartAgent 10.1.3 为 10.1.x 维护版本。由于 10.1.2 版本未单独发布，其变更内容已合入 10.1.3 一并发布。本版本集成 NodejsAgent 8.0.1、SDKAgent 5.16.1、NginxAgent 3.10.2 等子探针升级。
10.1.2 版本变更（合入 10.1.3 发布）
-
✨ NodejsAgent 8.0.1：elasticsearch 采集优化、amqplib 无事务 RabbitMQ 独立后端支持；修复 Node.js 16.17+～18.18 及 ESM 无扩展名 import 启动失败（影响范围：SmartAgent 10.1.0～10.1.1）
-
✨ SDKAgent 5.16.1：支持 Node.js 探针对接独立后端接口
-
🔧 NginxAgent 3.10.1：修复调用链中远程调用地址多了一个 80 端口的问题（影响范围：SmartAgent 7.3.3～10.1.1）
10.1.3 版本变更
- 🔧 NginxAgent 3.10.2：修复探针日志中大量
url.len <= offset警告（影响范围：SmartAgent 9.12.6～10.1.2）
升级建议
- 使用 NodejsAgent 8.0.0 且 Node.js 应用在 16.17+～18.18 或 ESM 无扩展名 import 场景启动失败的环境，建议尽快升级；
- 使用 NginxAgent 且调 用链远程调用地址多出 80 端口，或探针日志存在大量
[warn] url.len <= offset警告的 Nginx 环境，建议尽快升级； - 需 Node.js 探针对接独立后端接口 的场景应升级至本版本。
Linux x86_64 系统
支持平台版本
- One 平台：V2.2.2 及以上版本
集成探针版本
- JavaAgent: 9.14.0
- DotnetAgent: 6.16.1
- PHPAgent: 8.7.0
- PythonAgent: 8.7.4
- NodejsAgent: 8.0.1
- NginxAgent: 3.10.2
- ApacheAgent: 3.5.0
- SDKAgent: 5.16.1
- GoAgent: 5.0.3
- logsAgent: 3.0.1
10.1.2 版本变更（合入 10.1.3 发布）
1. NodejsAgent 升级至 8.0.1
新增功能
- elasticsearch 采集优化：避免重复采集内部 HTTP 调用；
- amqplib 组件增强：支持无事务 RabbitMQ 独立后端调用指标采集。
修复 Bug
- 修复 Node.js 16.17+～18.18 版本应用启动失败问题（影响范围：NodejsAgent 8.0.0，对应 SmartAgent 10.1.0～10.1.1）。
- 现象：在 Node.js 16.17+～18.18 环境中启动时报错：
SyntaxError: The requested module "node:module" does not provide an export named 'register'。
- 现象：在 Node.js 16.17+～18.18 环境中启动时报错：
- 修复 ESM 模块无扩展名 import 启动失败问题（影响范围：NodejsAgent 8.0.0，对应 SmartAgent 10.1.0～10.1.1）。
- 在特定模块引入场景下，探针会引发启动报错。注意：纯 CommonJS 应用不影响，不会有此问题。
- 具体报错信息：
Error [ERR_MODULE_NOT_FOUND]: Cannot find module '/app/scripts/sync/index' at .../opt/bonree/apm/agent/nodejs/8.0.0/Bonree/node_modules/import-in-the-middle/hook.js。
2. SDKAgent 升级至 5.16.1
新增功能
- 支持 Node.js 探针对接独立后端接口。
3. NginxAgent 升级至 3.10.1
修复 Bug
- 修复调用链中远程调用地址多了一个 80 端口的问题（影响范围：NginxAgent 2.5.0 之后版本，对应 SmartAgent 7.3.3～10.1.1）。
10.1.3 版本变更
1. NginxAgent 升级至 3.10.2
修复 Bug
- 修复探针日志存在大量
[warn] 19#19: url.len <= offset. ...警告的问题（影响范围：NginxAgent 3.8.5～3.10.1，对应 SmartAgent 9.12.6～10.1.2）。 - 具体场景：proxy_pass 场景 url 和 location 长度相同时，即
url.len == offset，不应报 warn。
Linux ARM64 系统
支持平台版本
- One 平台：V2.2.2 及以上版本
集成探针版本
- JavaAgent: 9.14.0
- DotnetAgent: 6.16.1
- PHPAgent: 8.7.0
- PythonAgent: 8.7.4
- NginxAgent: 3.10.2
- SDKAgent: 5.16.1
- GoAgent: 5.0.3
- logsAgent: 3.0.1
10.1.2 版本变更（合入 10.1.3 发布）
1. SDKAgent 升级至 5.16.1
新增功能
- 支持 Node.js 探针对接独立后端接口。
2. NginxAgent 升级至 3.10.1
修复 Bug
- 修复调用链中远程调用地址多了一个 80 端口的问题（影响范围：NginxAgent 2.5.0 之后版本，对应 SmartAgent 7.3.3～10.1.1）。
10.1.3 版本变更
1. NginxAgent 升级至 3.10.2
修复 Bug
- 修复探针日志存在大量
[warn] 19#19: url.len <= offset. ...警告的问题（影响范围：NginxAgent 3.8.5～3.10.1，对应 SmartAgent 9.12.6～10.1.2）。 - 具体场景：proxy_pass 场景 url 和 location 长度相同时，即
url.len == offset，不应报 warn。
平台说明
- ARM64 平台暂不支持 NodejsAgent、ApacheAgent，因此 10.1.2 中 NodejsAgent 8.0.1 相关变更不适用本平台。
Windows x86_64 平台
支持平台版本
- One 平台：V2.2.2 及以上版本
集成探针版本
- JavaAgent: 9.14.0
- DotnetAgent: 6.16.1
- logsAgent: 3.0.1
平台说明
本版本 Windows 平台无 10.1.2 及 10.1.3 功能变更，集成探针版本与 10.1.1 保持一致。
兼容性说明
平台兼容性
| 操作系统 | 支持架构 | 最低 One 版本 |
|---|---|---|
| Linux | x86_64 | V2.2.2 |
| Linux | ARM64 | V2.2.2 |
| Windows | x86_64 | V2.2.2 |